WebStore

The WebStore section of the web.config file allows you to configure the policies of the webStore application. It contains the following attributes.

Attribute

Use

defaultSalesOrderShipViaCode

If specified, identifies the default shipping method for new sales orders. The value must be an existing ShipViaCd sent by the KS_FREIGHT API.

googleAnalyticsAccount

The Google Analytics account. If specified, the system sends page and transaction information to Google with the value of this attribute. The value must be a valid account provided by Google in order to use the Google tools.

googleGeocodingApiKey

This is the key for the Google Geocode API when searching for agencies. If not specified, searches are not performed.

googleMapsApiKey

The key for the Google Maps API. Click here for instructions on acquiring a Google Maps API Key.

googleRecaptchaSecretKey

This key is the secret key for the recaptcha service. Click here for instructions on acquiring a Google reCAPTCHA.

googleRecaptchaSiteKey

This key is the site key for the recaptcha service. Click here for instructions on acquiring a Google reCAPTCHA.

showTermsAndConditions

If true, shows the terms and conditions page and a checkbox for users to confirm that they agree to these terms before checking out. If specified, the value must be true or false. If not specified, the default for this attribute is true to show the terms and conditions.

termsAndConditionsAgreementText

If specified, overrides the label text for the term and conditions checkbox on the checkout order review page.

anonymousWarehousePlant

If specified, sets the warehouse plant code for the anonymous user. This could impact pricing for anonymous users if your ERP system is designed based on warehouse location.

defaultClassViewStyle

If specified, sets the default view style for catalog class lists. Valid values are:

  • List - A vertically oriented list.
  • Grid - A grid layout with multiple items per row. This is the default.
  • GridList - Defaults to a grid layout with a control to switch between list and grid.

defaultProfileViewStyle

If specified, sets the default view style for catalog profile lists. Valid values are:

  • List - A vertically oriented list.
  • Grid - A grid layout with multiple items per row. This is the default.
  • GridList - Defaults to a grid layout with a control to switch between list and grid.

defaultShowProfilesForClass

If specified, sets the default option for selecting profiles to display browsing the class catalog:

  • Class - Only display profiles for the current class
  • ChildClasses - Display profiles for the current class and all child classes.

defaultPriceBasis

If specified, sets the price basis when calculating the sale price for an item if there is none specified for the current business.

defaultPriceSheet

If specified, sets the price sheet when calculating the sales price for an item when there is none specified for the current business.

defaultSortProperty

If specified, sets the default sort property for the item class catalog. This must be a valid property name for the ItemProfile object. Example “ItemProfilePrice”. Refer to the Object Security page to view the available properties for this object.

defaultSortOrder

If specified, sets the default sort order for the item class catalog. Valid values are "A" - ascending or "D" - descending.

defaultSortLabel

If specified, sets the sort label for the default sort property. Example: “Price”

defaultSortOrderLabel

If specified, sets the sort order label for the default sort property. Example: “(Low to High)”

enableSearchPropertyService

If true, the system enables the search property service. If specified, the value must be "true" or "false".

showPaymentTermsXref

If true, the system uses the payment terms cross-reference sent from your ERP system when displaying the payment terms. If not specified, or the value is false, the system uses application logic to derive the description based on the payment terms data. All Payment terms data is sent by the KS_CUSTOMERS API.

showMaximumQuantityDiscount

If true, when calculating prices for display in the catalog the maximum quantity discount will be used, otherwise the single quantity price will be displayed.

shareButtonsServices

A list of service codes from AddToAny, separated by spaces, to show as buttons on profile pages. If specified, enables share/social media buttons on product listings. Options entered are case-sensitive and must be all lower case. Entering the "+" options causes a + button to appear on the listings. When clicked, it allows the user to view and choose from all available sharing options.

settleOnOrderImport

If true, the system settles credit card authorizations for an order when it is imported from the back-office system. If false, the system settles credit card authorizations when the invoice is imported from the back-office system. If not specified, the default value for this setting is false.

catalogItemsPerPage

If specified, contains a comma-separated list of the options for the number of items per page dropdown on catalog pages. If not specified, the default is 12, 24, 48. The first item in the list is the default value to use. If only one value is specified, the dropdown does not appear.

defaultListName

Sets the default name of new shop-lists. If not specified, users must specify the name of lists.

isDefaultListPrivate

If true, specifies that shop-lists are created as private by default. If false, the new shop-lists are created as shared by default. If not specified, the default value is true which means that new shop-lists default to private.

showNonSellableProfiles

If true, non-sellable profiles will be selected and displayed when browsing the class catalog. If false, non-sellable profiles will not be selected and displayed in the class catalog. Default is true.

isPromptToCombineCarts

If true, users are prompted after signing in to resolve conflicts when there are both session and contact carts. If false, there is no promp and the user keeps their session cart and the contact cart is removed. If not specifed, the default is false for no prompting.

displayItemIdAsLabel

If specified, the system displays the item profile identifier when displaying product, using the value as the label. If not specified, the system displays "Item".

displayMfgItemIdAsLabel

If specified, the system displays the item master identifier when displaying product, using the value as the label. If not specified, the system does not display the item master identifier.

quoteExpireDays

Specifies the number of days a quote is valid for before it is considered expired. Expired quotes can have their items added to the quote, but they will be priced at their current value and not the quote value.

quoteDeleteDays

Specifies the number of days before a quote will be deleted if it has not been converted to an order.

historicalPurchaseDays

Specifies the number of days to include for historical purchasing queries, default is 365.

enableBrandFilter

Set to true to include the brand filter in catalog pages. Default is false.

enableKapiPricing

Set to true to use KAPI real-time pricing. Default is false. If set to true, you must also configure the KourierRestConfiguration element.

kapiDefaultCustomerId

The default customer ID for KAPI pricing. This will be used in the case a XrefId cannot be found for the current user.

zeroPricingOK

Set to true to enable zero price values to be returned.

quickOrderMinLineCount

Specifies the minimum number of lines to display on the quick order form. If not specified, the default is 10, so 10 blank rows are created.

catalogRefreshFrequency

Sets the frequency the catalog summary tables are refreshed in minutes. The default is 3 minutes.

searchIndexFrequency

Set the frequency the search index is updated in minutes. The default is 30 minutes.

classMissingImagePath

Path of the no-image image for item classes. The default is null, which will not display the no-image image.

profileMissingImagePath

Path of the no-image image for item profiles. The default is null, which will not display the no-image image.

salesEmailAddress

The reply-to email address of sales order confirmations. The default value is null. If null, the value in ChannelSettings/customerServiceEmailAddress is used instead.

paymentOptionMessageForWillCall

Optional payment option for order to be picked up at a will-call warehouse. The value of this setting will be displayed as a payment option during checkout for orders that will be picked up at a will-call warehouse. This value will be included in the order comments if selected.

paymentOptionMessageForShipment

Optional payment option for orders to be shipped. The value of this setting will be displayed as a payment option during checkout for orders that will be shipped. This value will be included in the order comments if selected.

defaultRegion

The default warehouse to be used when a customer has no region defined or for the anonymous user (assuming they have permission to see inventory availability).

cartRetentionDays

The number of days to retain carts. The default is 14 days if not set. If 0, then carts associated to a contact are not deleted. Note that carts with no items and guest carts that not associated to a contact are deleted after 2 days.

orderConfirmationPage

The name of the page the system will redirect users to after they finish checking out. If no page is specified, then the page name defaults to Checkout_OrderSuccess.

wunderKindSmartTagAccountNo

This number controls WunderKind analytics. If absent, WunderKind analytics is disabled. The number is taken from the SmartTags implementation instructions supplied by WunderKind.

supportPunchout

true/false. Allows for the site to be viewed via a punchout cxml provider.

enableInStockFilter

true/false. Enables the InStockFilter in the catalog, default is false.

remoteSignInSecretKey

Symmetric secret key for remote sign in token generation.

remoteSignInIssuer

Issuer domain for remote sign in.

Example Usage

<WebStore shareButtonsServices="facebook email pinterest +" googleAnalyticsAccount="UA-8765432-1" defaultSalesOrderShipViaCode="E4" anonymousWarehousePlant="ALL" defaultSortProperty="PopularityRating" defaultSortOrder="D" defaultSortLabel="Top Sellers" defaultSortOrderLabel=" " />